package com.evildog.workspace.life.application.forest;

import com.dtflys.forest.annotation.Request;
import com.evildog.workspace.life.application.bo.CalendarDayBO;
import com.evildog.workspace.life.application.bo.CalendarHolidayBO;

/**
 * 万年历接口
 *
 * 免费用户，api每天只能访问20次
 *
 * @link {https://www.juhe.cn/docs/api/id/177}
 */
public interface CalendarApi {

    /**
     * 根据传入年份返回当年假期列表
     * @param year 年份
     * @param key 开发key
     */
    @Request(url = "http://v.juhe.cn/calendar/year?year=${0}&key=${1}",
            dataType = "json")
    CalendarHolidayBO getCalendarHoliday(String year, String key);


    /**
     * 根据传入年份返回当年假期列表
     * @param date 日期 2020-1-1
     * @param key 开发key
     */
    @Request(url = "http://v.juhe.cn/calendar/day?date=${0}&key=${1}",
            dataType = "json")
    CalendarDayBO getCalendarDay(String date, String key);


}
